package com.hmall.api.client.fallback;

import com.hmall.api.client.ItemClient;
import com.hmall.api.dto.ItemDTO;
import com.hmall.api.dto.OrderDetailDTO;
import com.hmall.common.exception.BizIllegalException;
import com.hmall.common.utils.CollUtils;
import lombok.extern.slf4j.Slf4j;
import org.springframework.cloud.openfeign.FallbackFactory;

import java.util.Collection;
import java.util.List;

/**
 * ItemClient的熔断降级工厂
 * 功能：当调用商品服务失败时，提供备选处理逻辑
 */
@Slf4j
public class ItemClientFallback implements FallbackFactory<ItemClient> {

    /**
     * 创建降级代理对象
     * @param cause 触发降级的异常
     * @return ItemClient的降级实现
     */
    @Override
    public ItemClient create(Throwable cause) {
        return new ItemClient() {

            /**
             * 批量查询商品信息的降级方法
             * @param ids 商品ID集合
             * @return 空集合（查询失败时返回默认值）
             */
            @Override
            public List<ItemDTO> queryItemByIds(Collection<Long> ids) {
                log.error("远程调用ItemClient#queryItemByIds失败，参数：{}", ids, cause);
                // 购物车等场景允许商品信息缺失，返回空集合
                return CollUtils.emptyList();
            }

            /**
             * 扣减库存的降级方法
             * @param items 订单详情列表
             * @throws BizIllegalException 抛出业务异常触发事务回滚
             */
            @Override
            public void deductStock(List<OrderDetailDTO> items) {
                log.error("远程调用ItemClient#deductStock失败，参数：{}", items, cause);
                // 库存扣减失败需触发事务回滚，不允许降级
                throw new BizIllegalException("库存服务暂时不可用", cause);
            }

            /**
             * 单商品查询的降级方法
             * @param id 商品ID
             * @return null（查询失败时返回默认值）
             */
            @Override
            public ItemDTO queryItemById(Long id) {
                log.error("远程调用ItemClient#queryItemById失败，参数：{}", id, cause);
                // 商品详情页允许展示部分信息，返回null由前端处理
                return null;
            }
        };
    }
}